home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / standard / ldgetsymstr.z / ldgetsymstr
Encoding:
Text File  |  1998-10-30  |  2.8 KB  |  67 lines
  1.  
  2.  
  3.  
  4. LLLLDDDDGGGGEEEETTTTSSSSYYYYMMMMSSSSTTTTRRRR((((3333XXXX))))                                                LLLLDDDDGGGGEEEETTTTSSSSYYYYMMMMSSSSTTTTRRRR((((3333XXXX))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ldgetsymstr - get a symbol type string
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssttttddddiiiioooo....hhhh>>>>
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ffffiiiilllleeeehhhhddddrrrr....hhhh>>>>
  14.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyymmmmssss....hhhh>>>>
  15.      ####iiiinnnncccclllluuuuddddeeee <<<<llllddddffffccccnnnn....hhhh>>>>
  16.  
  17.      iiiinnnntttt llllddddggggeeeettttssssyyyymmmmssssttttrrrr ((((ldptr, psymr,isym,buffer))))
  18.      LLLLDDDDFFFFIIIILLLLEEEE ****ldptr;
  19.      PPPPSSSSYYYYMMMMRRRR ****psymr;
  20.      iiiinnnntttt isym;
  21.      iiiinnnntttt flags;
  22.      cccchhhhaaaarrrr ****buffer;
  23.  
  24. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  25.      _l_d_g_e_t_s_y_m_s_t_r puts, in the caller-provided buffer, a string with whatever
  26.      type information is available on the symbol passed in.  There is no
  27.      mechanism to prevent buffer overflow, so it is best to provide a large
  28.      buffer.  2048 bytes should be 10 or 20 times the size of any reasonable
  29.      string.  The string put in bbbbuuuuffffffffeeeerrrr is terminated by a null(0) byte by
  30.      _l_d_g_e_t_s_y_m_s_t_r.
  31.  
  32.      Both a symbol index (as is supplied to _l_d_t_b_r_e_a_d ) and a ppppSSSSYYYYMMMMRRRR ppppooooiiiinnnntttteeeerrrr
  33.      pointing to the data for the indexed symbol (previously filled by a call
  34.      to ldtbread) must be passed to _l_d_g_e_t_s_y_m_s_t_r.
  35.  
  36.      _l_d_g_e_t_s_y_m_s_t_r returns SSSSUUUUCCCCCCCCEEEESSSSSSSS if it has  been able to access the symbol
  37.      table or NNNNUUUULLLLLLLL if it has not.
  38.  
  39.      If the symbol is simply a label (as in assembler code), the string put in
  40.      the buffer will be of length 0 (that is, the zero byte of the buffer will
  41.      be set to 0).
  42.  
  43.      The program must be loaded with the object file access routine library
  44.      lllliiiibbbbmmmmlllldddd....aaaa.
  45.  
  46. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  47.      fopen(3S), ldopen(3X), ldtbread(3X), ldclose(3X), ldfcn(4).
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.